home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 #2 / Ham Radio 2000 - Volume 2.iso / HAMV2 / SATELLIT / WINORB34 / README.TXT < prev    next >
Text File  |  1997-04-06  |  8KB  |  181 lines
  1. README.TXT                  WinOrbit 3.3            7 Apr 97
  2.  
  3. An artificial earth-satellite tracking and display program for 
  4. Windows 3.1, OS/2 or Win95.  May also work with WinNT.
  5.  
  6. Installation
  7. ------------
  8. UNZIP the file.  Be sure that you use the proper settings for
  9. UNZIP to retain [relative] path names.  Some subdirectories
  10. should be created.  Start the program with "Run" from Program 
  11. Manager or File Manager (or double-click the filename in File 
  12. Manager).  
  13. See below for required file VBRUN300.DLL. 
  14.  
  15. Documentation
  16. -------------
  17. In addition to the files *.TXT, which should get you started,
  18. there is a very extensive Windows Help file (WinOrbit.Hlp).  
  19. Read it!  Choose "Help:Help", and start by reading the 
  20. instructions in "Setting up the Program".  In case of trouble, 
  21. see the hints below.
  22.  
  23. Upgrade installation - customization files
  24. ------------------------------------------
  25. If you have previously edited the .QTH files, be sure to save 
  26. them (or answer NO to the unzip question about duplicate 
  27. files).  The .INI file will be automatically updated when you 
  28. Save Settings.  If upgrading from 2.x to 3.0, read the file
  29. UPDATE.TXT.  If you have 3.x, back up your SAT\DATABASE.2LI
  30. file before unzipping the new software, otherwise it will be
  31. overwritten.
  32.  
  33. A note about SVGA displays
  34. --------------------------
  35. WinOrbit presents a lot of information on the screen.  Some older 
  36. displays may not have enough resolution to fit it all in.  Every 
  37. attempt has been made to make it usable on a minimum display of 
  38. 640x480 at 15 twips/inch. Choose "Help:System Info" to find out 
  39. what your display resolution is.  If you cannot see all the 
  40. features on the maps, try "Setup:Colors..."
  41.  
  42. The program works fine on 16, 256, and 16-million-color displays. 
  43. In the past there has been a problem with the maps on 32k and 
  44. 64k-color displays.  Try changing the colors to see if that helps.
  45. If it does, let me know.  (The ocean is supposed to be blue and the 
  46. landmass an olive-green, in the default color settings.)  I believe
  47. this has been fixed in 3.0, but there are now some problems with
  48. 256-color (palette-based) displays.
  49.  
  50.  
  51. A note about date and time formats and the "millenium bug"
  52. ----------------------------------------------------------
  53. Windows allows the user to customize the date and time format (for
  54. example 12 vs. 24 hour time, or European vs. American date order).
  55. Unfortunately, this makes the programmer's job a bit harder.  I 
  56. haven't tested every combination of formats.  However, the 
  57. following should work:
  58.      12 or 24 hour time (with or without AM/PM annotation)
  59.      Short Date formats "DMY" and "MDY"
  60. If you find a particular format that fails, please let me know.
  61.  
  62. In version 3.0, I have attempted to be sure that the program will
  63. continue to work after Jan 1, 2000.  One major uncertainty is how
  64. the kep epochs will be handled after that date.  I'm assuming that
  65. they will become either 00001.0001 or 100001.001 (after 99365.999).
  66.  
  67. To change date and time formats, use the "International" Control 
  68. Panel that is part of Windows.
  69.  
  70. Windows 95 and NT
  71. -----------------
  72. The program does run under Windows 95.  There may be some problems
  73. with long directory names.  To be on the safe side, stick with 
  74. the old DOS 8.3 name conventions.
  75.  
  76. OS/2
  77. ----
  78. WinOrbit works under OS/2.  Set it up as you would any Windows
  79. program.
  80.  
  81. International users (including Canadians)
  82. -----------------------------------------
  83. WinOrbit should work correctly with any setting of the Country
  84. in the Windows International Control Panel.  Please read the 
  85. above about date/time formats.  Also, please note that the 
  86. Number Format in the International Control Panel must use 
  87. different "decimal separator" and "1000s separator" characters. 
  88. (This is the normal condition, i.e. "."/"," or ","/".", but 
  89. not "."/"."of ".", not ",".  Please report any strange 
  90. occurrences (numbers rounded or truncated, for example). Thanks.  
  91. If you have difficulty with the program, I'd appreciate hearing
  92. the specifics - what went wrong, what the Control Panel settings
  93. were, and what (if anything) you changed to fix it.
  94.  
  95. Getting updates
  96. ---------------
  97. I will try to post updated versions to oak.oakland.edu and 
  98. ftp.amsat.org.  Look for WINORBxx.ZIP, where xx is the version
  99. number (e.g. version 2.3 --> WINORB23.ZIP).  Also check out the
  100. WinOrbit web site (see the Help file).
  101.  
  102. In case of trouble
  103. ------------------
  104. 1) if the program ran once, but won't run now, delete the file
  105.        C:\WINDOWS\WINORBIT.INI (or rename it) and try again
  106. 2) read the help file (WINORBIT.HLP) using Windows Help:
  107.        -Start Help by choosing Help in Notepad, FileManager
  108.          or Program Manager, [or WinOrbit if it is running].
  109.        -Choose the "File:Open" menu item and select "winorbit.hlp"
  110.        -Read about "Setup" and "Troubleshooting"
  111. 3) contact the author (as described in the help file).
  112.  
  113.  
  114. Files included in distribution (WINORB28.ZIP)
  115. ---------------------------------------------
  116. (See UPDATE.TXT for directory info)
  117. WINORBIT.EXE - the program
  118. WINORBIT.HLP - the help file (manual)
  119. LATLONG.QTH  - sample observer location database
  120. LAUNCH.QTH   - Worldwide satellite launch points (for map)
  121. README.TXT   - this file
  122. READMExx.TXT - update file (e.g. README21.TXT)
  123. CMDIALOG.VBX - Visual Basic library file
  124. GRID.VBX     - Visual Basic library file
  125. WINORB.DLL   - Windows Dynamic Link Library file
  126. DIBAPI.DLL   - Windows Dynamic Link Library file
  127. USERALGO.DLL - Windows Dynamic Link Library file
  128.  
  129. DATABASE.2LI - Satellite Database file
  130. AO-10.ATT    - Attitude file for Oscar 10
  131. AO-13.ATT    - Attitude file for Oscar 13
  132. DO-17.SKD    - Automation schedule file for DO-17 (sample)
  133. MIR.SKD      - Automation schedule file for MIR (sample)
  134.  
  135. ORBS-xxx.KEP - sample satellite data file in AMSAT format
  136. ORBS-xxx.2LI - sample satellite data file in NASA format
  137. STS73.VEC    - sample data file in Vector and AMSAT formats
  138.  
  139. Additional file *** REQUIRED ***
  140. --------------------------------
  141. VBRUN300.DLL - Visual Basic library file 
  142.      This is a big file, so I left it out of the program archive,
  143.      but it is available from many places (as VBRUN30x.EXE,
  144.      self-extracting archive file).  
  145.      For example: ftp.amsat.org: /amsat/software/windows/
  146.                   oak.oakland.edu: /pub3/simtel-win3/dll/
  147.                   http://www.sat-net.com/winorbit
  148.  
  149. WARNING
  150. -------
  151. This program is free.  There is an old adage: "you get what you 
  152. pay for".  Do NOT assume that the orbital calculations are 
  153. correct.  Always check the results of this (or any program) 
  154. before making any critical decisions.  I make absolutely no 
  155. guarantees of any sort.  Commercial use is prohibited.
  156.  
  157.  
  158. Copyrights and stuff
  159. --------------------
  160. The program and associated files are copyrighted by the
  161. author.  You have permission to use these files non-
  162. commercially.  If you redistribute, please include all the
  163. files in the original .zip file.
  164.  
  165. Visual Basic and Windows 3.1 are products of Microsoft.  The 
  166. author of this program has licensed copies of both products.  
  167.  
  168. VBRUN300.DLL and CMDIALOG.VBX are products of Microsoft.  They 
  169. are provided free of charge to users of WinOrbit by the author, 
  170. under the terms of the Microsoft license.  Same for GRID.VBX.
  171. DIBAPI.DLL is based on sample code provided by Microsoft, but 
  172. they are not responsible for my implementation of it.
  173.  
  174. This package was archived with the Info-Zip program Zip 2.0. 
  175. Info-ZIP's software (Zip, UnZip and related utilities) is
  176. free and can be obtained as source code or executables 
  177. from various anonymous-ftp sites, including: 
  178.     ftp.uu.net:/pub/archiving/zip/*, and
  179.     oak.oakland.edu:/pub/msdos/zip/*
  180.  
  181.